package cn.iocoder.yudao.module.custom.service.province;

import java.util.*;
import javax.validation.*;
import cn.iocoder.yudao.module.custom.controller.admin.province.vo.*;
import cn.iocoder.yudao.module.custom.dal.dataobject.province.ProvinceDO;
import cn.iocoder.yudao.framework.common.pojo.PageResult;

/**
 * 省级信息 Service 接口
 *
 * @author 芋道源码
 */
public interface ProvinceService {

    /**
     * 创建省级信息
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    String createProvince(@Valid ProvinceCreateReqVO createReqVO);

    /**
     * 更新省级信息
     *
     * @param updateReqVO 更新信息
     */
    void updateProvince(@Valid ProvinceUpdateReqVO updateReqVO);

    /**
     * 删除省级信息
     *
     * @param id 编号
     */
    void deleteProvince(String id);

    /**
     * 获得省级信息
     *
     * @param id 编号
     * @return 省级信息
     */
    ProvinceDO getProvince(String id);

    /**
     * 获得省级信息列表
     *
     * @param ids 编号
     * @return 省级信息列表
     */
    List<ProvinceDO> getProvinceList(Collection<String> ids);

    /**
     * 获得省级信息分页
     *
     * @param pageReqVO 分页查询
     * @return 省级信息分页
     */
    PageResult<ProvinceDO> getProvincePage(ProvincePageReqVO pageReqVO);

    /**
     * 获得省级信息列表, 用于 Excel 导出
     *
     * @param exportReqVO 查询条件
     * @return 省级信息列表
     */
    List<ProvinceDO> getProvinceList(ProvinceExportReqVO exportReqVO);

}
